MCSetVisible(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 2 - Movie Controller Components / Movie Controller Components Reference

Movie Controller Functions / Managing Controller Attributes

MCSetVisible
The MCSetVisible function allows your application to control the visibility of a movie controller.
pascal ComponentResult MCSetVisible (MovieController mc, 
                                     Boolean visible);
mc
Specifies the movie controller for the operation. You obtain this identifier from the Component Manager's OpenComponent or OpenDefaultComponent function, or from the NewMovieController function (described on page 2-28).
visible
Specifies the action for this function. Set the visible parameter to true to cause the controller to be visible. Set this parameter to false to make the controller invisible.

DESCRIPTION
Movie controller components support badges, which allow you to create a visual
cue that helps the user distinguish between static images and images that represent movies. The movie controller component displays a badge in the movie image whenever the movie is visible but the control portion of the controller is not visible. To work with movie controller badges, you must use the mcActionSetUseBadge action, which is described in "Movie Controller Actions" beginning on page 2-15.

SPECIAL CONSIDERATIONS
By default, a new controller is hidden so that your application can freely set the display attributes before showing the controller to the user. You should note, however, that the MCNewAttachedController function (described on page 2-30) automatically sets the movie controller to be visible. Your application must make the controller visible before the user can work with its associated movie.

SEE ALSO
You can use the MCGetVisible function, described in the next section, to determine the visibility of a movie controller.